self-evolve-framework 1.0.7 → 1.1.0

package/README.md

@@ -45,13 +45,15 @@ npx self-evolve-framework init --skip-impeccable
 │   ├── self-evolve.mdc    ← 编排层（always 激活）
 │   └── ponytail.mdc       ← 代码最小化原则
 ├── skills/
-│   └── skillopt-sleep/
-│       └── SKILL.md       ← 离线进化分析
+│   ├── skillopt-sleep/
+│   │   └── SKILL.md       ← 离线进化分析
+│   └── impeccable/
+│       └── SKILL.md       ← 设计质量审计
 CLAUDE.md                  ← 追加自我进化章节
 ```
 
-安装过程还会自动运行 `npx impeccable install` 安装 [Impeccable](https://impeccable.style) 设计质量检查工具（可用 `--skip-impeccable` 跳过）。
-首次使用前请在 CodeBuddy 对话中运行 `/impeccable init` 创建设计上下文。<!-- 命令由 Impeccable 技能处理 -->
+> 可选：用 `--skip-impeccable` 跳过 Impeccable skill 安装。
+> 首次使用前在 CodeBuddy 对话中输入 `impeccable init` 创建设计上下文。
 
 ## 使用
 
@@ -78,7 +80,7 @@ impeccable polish          → 页面润色
 
 ### 设计上下文
 
-Impeccable 首次使用前运行 `/impeccable init` 生成 `PRODUCT.md` 和 `DESIGN.md`。<!-- 该命令由 Impeccable 技能处理 -->
+在 CodeBuddy 对话中输入 `impeccable init` 生成 `PRODUCT.md` 和 `DESIGN.md`，让后续审计更精准。
 
 ## 前提
 
@@ -91,13 +93,15 @@ Impeccable 首次使用前运行 `/impeccable init` 生成 `PRODUCT.md` 和 `DES
 ```
 self-evolve-framework/
 ├── package.json          # npm 包配置
-├── bin/cli.js            # CLI 安装工具（含 Impeccable 自动安装）
+├── bin/cli.js            # CLI 安装工具
 ├── template/
 │   ├── rules/
 │   │   ├── self-evolve.mdc   ← 编排层（含 Impeccable 集成）
 │   │   └── ponytail.mdc
 │   └── skills/
-│       └── skillopt-sleep/
-│           └── SKILL.md      ← 离线进化引擎（含设计质量分析）
+│       ├── skillopt-sleep/
+│       │   └── SKILL.md      ← 离线进化引擎（含设计质量分析）
+│       └── impeccable/
+│           └── SKILL.md      ← 设计质量审计 skill
 └── README.md
 ```

package/bin/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { readFileSync, writeFileSync, existsSync, mkdirSync, cpSync } from "fs"
+import { readFileSync, writeFileSync, existsSync, mkdirSync, cpSync, readdirSync, statSync } from "fs"
 import { join, resolve } from "path"
 import { fileURLToPath } from "url"
 
@@ -9,13 +9,17 @@ const TEMPLATE_DIR = resolve(__dirname, "../template")
 
 const COMMANDS = {
   init: {
-    desc: "安装自我进化飞轮到当前项目",
+    desc: "一键安装全部 CodeBuddy skill + 规则到当前项目",
     run: async (args) => init(args),
   },
   sync: {
-    desc: "从源项目同步配置到当前项目",
+    desc: "从框架项目同步最新的 skill + 规则到当前项目",
     run: async (args) => sync(args),
   },
+  list: {
+    desc: "列出模板中包含的所有 skill 和规则",
+    run: () => listSkills(),
+  },
   help: {
     desc: "显示帮助信息",
     run: () => showHelp(),
@@ -27,22 +31,49 @@ function showHelp() {
   self-evolve — CodeBuddy 自我进化飞轮安装工具
 
   用法:
-    npx self-evolve-framework init       安装到当前项目
-    npx self-evolve-framework sync       从源项目同步
+    npx self-evolve-framework init       一键安装全部 skill + 规则
+    npx self-evolve-framework list       列出模板中包含的所有 skill
+    npx self-evolve-framework sync       从框架同步最新版本
 
   选项:
     --project <path>      指定目标项目路径（默认当前目录）
     --skip-claude-md      跳过更新 CLAUDE.md
-    --skip-impeccable     跳过安装 Impeccable 设计质量工具
+    --skip-impeccable     跳过 Impeccable 设计质量 skill
     --dry-run             预览要复制的文件，不实际写入
 
   示例:
     npx self-evolve-framework init
     npx self-evolve-framework init --project ./my-app
-    npx self-evolve-framework init --skip-claude-md --skip-impeccable --dry-run
+    npx self-evolve-framework init --skip-claude-md --dry-run
   `)
 }
 
+function listSkills() {
+  const rulesDir = resolve(TEMPLATE_DIR, "rules")
+  const skillsDir = resolve(TEMPLATE_DIR, "skills")
+  console.log("\n📦 模板中包含的规则：")
+  if (existsSync(rulesDir)) {
+    for (const f of readdirSync(rulesDir).filter(f => f.endsWith(".mdc")).sort()) {
+      console.log(`  rules/${f}`)
+    }
+  }
+  console.log("\n🧠 模板中包含的技能：")
+  if (existsSync(skillsDir)) {
+    for (const d of readdirSync(skillsDir).filter(f => statSync(join(skillsDir, f)).isDirectory()).sort()) {
+      const skillMd = join(skillsDir, d, "SKILL.md")
+      let desc = ""
+      if (existsSync(skillMd)) {
+        const firstLine = readFileSync(skillMd, "utf-8").split("\n").find(l => l.startsWith("description:"))
+        if (firstLine) desc = firstLine.replace("description: ", "").trim()
+      }
+      console.log(`  ${d}/  ${desc ? "— " + desc : ""}`)
+    }
+  }
+  if (!existsSync(rulesDir) && !existsSync(skillsDir)) {
+    console.log("  （模板目录为空）")
+  }
+}
+
 async function init(args) {
   const baseDir = resolve(args["--project"] || process.cwd())
   const dryRun = !!args["--dry-run"]
@@ -52,40 +83,36 @@ async function init(args) {
   console.log(`📍 项目路径: ${baseDir}`)
   console.log(`🧪 ${dryRun ? "DRY RUN — 不写入文件" : "执行中..."}\n`)
 
-  // 要复制的目录映射：{ 源相对路径 → 目标相对路径 }
-  const dirs = [
-    { src: "rules",  dest: ".codebuddy/rules" },
-    { src: "skills/skillopt-sleep", dest: ".codebuddy/skills/skillopt-sleep" },
-  ]
-
   let count = 0
-  for (const { src, dest } of dirs) {
-    const srcDir = resolve(TEMPLATE_DIR, src)
-    const destDir = resolve(baseDir, dest)
-    if (!existsSync(srcDir)) continue
-    if (!dryRun) mkdirSync(destDir, { recursive: true })
-    console.log(`${dryRun ? "  🔍 将复制" : "  ✅ 复制"}  ${src}/  →  ${dest}/`)
-    if (!dryRun) cpSync(srcDir, destDir, { recursive: true, force: true })
+
+  // 复制 rules（排除 .mdc 文件可以在以后细化）
+  const rulesSrc = resolve(TEMPLATE_DIR, "rules")
+  if (existsSync(rulesSrc)) {
+    if (!dryRun) {
+      mkdirSync(resolve(baseDir, ".codebuddy/rules"), { recursive: true })
+      cpSync(rulesSrc, resolve(baseDir, ".codebuddy/rules"), { recursive: true, force: true })
+    }
+    const ruleFiles = readdirSync(rulesSrc).filter(f => f.endsWith(".mdc"))
+    console.log(`  ${dryRun ? "🔍 将复制" : "✅ 复制"}  rules/  →  .codebuddy/rules/（${ruleFiles.length} 个规则）`)
     count++
   }
 
-  // 安装 Impeccable 设计质量工具
-  if (!skipImpeccable) {
+  // 复制 skills（排除 impeccable 如果 --skip-impeccable）
+  const skillsSrc = resolve(TEMPLATE_DIR, "skills")
+  if (existsSync(skillsSrc)) {
+    const skillDirs = readdirSync(skillsSrc).filter(f =>
+      statSync(join(skillsSrc, f)).isDirectory() &&
+      !(skipImpeccable && f === "impeccable")
+    )
+    const skillsDest = resolve(baseDir, ".codebuddy/skills")
     if (!dryRun) {
-      try {
-        console.log("\n📐 正在安装 Impeccable（设计质量检查工具）...")
-        const { execSync } = await import("child_process")
-        execSync("npx --yes impeccable install", { cwd: baseDir, stdio: "inherit" })
-        console.log("  ✅ Impeccable 安装完成")
-        console.log("  ℹ️  运行 /impeccable init 创建设计上下文（DESIGN.md + PRODUCT.md）")
-        count++
-      } catch {
-        console.log("  ⚠️  Impeccable 安装失败（网络问题？），可稍后手动运行 npx impeccable install")
+      mkdirSync(skillsDest, { recursive: true })
+      for (const dir of skillDirs) {
+        cpSync(join(skillsSrc, dir), join(skillsDest, dir), { recursive: true, force: true })
       }
-    } else {
-      console.log("  🔍 将安装  Impeccable（npx impeccable install）")
-      count++
     }
+    console.log(`  ${dryRun ? "🔍 将复制" : "✅ 复制"}  skills/  →  .codebuddy/skills/（${skillDirs.length} 个技能）`)
+    count++
   }
 
   // 更新 CLAUDE.md
@@ -119,11 +146,12 @@ async function init(args) {
   }
 
   console.log(`\n${dryRun ? `🔍 预览完成，共 ${count} 项操作` : `✅ 已完成 ${count} 项操作 — 下次对话即可生效`}`)
-  if (!dryRun) {
+  if (!dryRun && count > 0) {
     console.log("\n📖 使用指南（在 CodeBuddy 对话中输入）：")
     console.log("  skillopt-sleep dry-run  → 每日健康检查")
     console.log("  skillopt-sleep run      → 周改进提案")
     console.log("  impeccable audit/critique  → 设计质量审查")
+    console.log("  npx self-evolve-framework list  → 查看所有可用 skill")
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "self-evolve-framework",
-  "version": "1.0.7",
+  "version": "1.1.0",
   "description": "CodeBuddy 自我进化飞轮 — 仅适用于 CodeBuddy IDE。Post-Edit 验证闭环 + 规则自动推荐 + 离线进化分析",
   "type": "module",
   "bin": {

package/template/rules/CodeGraph.mdc

@@ -0,0 +1,23 @@
+---
+description: CodeBuddy 工具使用指南 — 何时用哪个工具
+alwaysApply: true
+---
+
+## CodeBuddy 代码探索指南
+
+### 工具选择原则
+
+| 问题类型 | 推荐工具 |
+|---------|---------|
+| "查找名为 X 的定义" | `search_content`（精确匹配）或 `task(code-explorer)`（范围探索） |
+| "X 被哪些地方调用？" | `search_content` 搜索引用 + `codebase_search` 语义搜索 |
+| "这个文件的结构是什么？" | `read_file` 读取文件 |
+| "目录下有哪些文件？" | `list_dir` 或 `search_file` 通配符匹配 |
+| "给我整个模块的上下文" | `task(code-explorer)` 子代理批量探索 |
+
+### 规则
+
+- **直接回答，不委托探索。** 对于架构问题，先 `read_file` 关键文件，再 `search_content` 追踪引用。不需要启动子代理来读文件。
+- **优先精确匹配。** 知道符号名时用 `search_content`（正则匹配），不确定时用 `codebase_search`（语义搜索）。
+- **批量读取优于多次单读。** 需要理解多个文件时一次 `read_file` 多文件，不要分多次调用。
+- **`task(code-explorer)` 适合大范围代码探索**（跨多个目录、多个模式搜索），简单查找直接用 `search_content`。

package/template/rules/Svelte_5.mdc

@@ -0,0 +1,167 @@
+---
+description: 
+alwaysApply: true
+enabled: true
+updatedAt: 2026-05-13T05:27:41.155Z
+provider: 
+---
+
+Svelte 5 项目编码规范（100% 严格遵循 Svelte 官方最新标准）
+完全遵循 Svelte 5 官方文档、官方最佳实践、$ 响应式规范、组件设计与目录结构，无任何自定义野路子。
+适用：Svelte 5 + SvelteKit 2/3（纯 Svelte / SvelteKit 通用）
+一、项目结构规范（官方标准）
+纯 Svelte 5 项目结构
+plaintext
+src/
+├── components/       # 可复用 UI 组件（官方推荐）
+├── lib/             # 工具函数、业务逻辑、TS 类型（官方固定目录）
+├── App.svelte       # 根组件
+├── main.ts          # 入口挂载文件
+└── app.css          # 全局样式
+SvelteKit + Svelte 5 项目结构
+plaintext
+src/
+├── routes/           # 路由页面（官方强制）
+├── lib/              # 工具、组件、store、工具函数（官方强制）
+│   ├── components/   # 公共组件
+│   ├── stores/       # 全局状态
+│   └── utils/        # 工具函数
+└── app.html          # 入口 HTML（官方固定）
+官方强制规则：
+工具 / 共享代码必须放在 src/lib/
+禁止随意创建根目录（如 utils/、helpers/）
+组件必须放在 lib/components/ 或同级路由内
+二、响应式规范（Svelte 5 官方唯一标准：$ 响应式）
+1. 声明响应式变量（官方唯一写法）
+svelte
+<script lang="ts">
+  // 基础响应式
+  let count = $state(0);
+
+  // 对象/数组（无需 $state.raw，Svelte 5 自动深度响应式）
+  let user = $state({ name: 'Svelte', age: 5 });
+</script>
+2. 计算属性（官方 $derived）
+svelte
+<script lang="ts">
+  let count = $state(0);
+
+  // 计算属性：自动依赖追踪
+  const double = $derived(count * 2);
+</script>
+3. 副作用（官方 $effect）
+svelte
+<script lang="ts">
+  let count = $state(0);
+
+  // 依赖变化时执行
+  $effect(() => {
+    console.log('count changed:', count);
+  });
+
+  // 挂载时执行一次
+  $effect(() => {
+    console.log('mounted');
+    return () => console.log('destroyed');
+  });
+</script>
+官方禁止：
+禁止使用 Svelte 4 的 $: 语法（已废弃）
+禁止手动实现响应式
+禁止使用第三方响应式库替代原生 API
+三、Props 传参规范（官方 $props()）
+svelte
+<script lang="ts">
+  // 官方标准 Props 声明
+  const { title = '默认标题', count } = $props<{
+    title?: string;
+    count: number;
+  }>();
+</script>
+规则：
+Props 必须使用 $props() 声明
+必须使用 TS 泛型约束类型
+禁止使用 export let（Svelte 5 兼容但不推荐）
+四、事件规范（官方标准）
+1. 子传父（官方 createEventDispatcher）
+svelte
+<script lang="ts">
+  import { createEventDispatcher } from 'svelte';
+  const dispatch = createEventDispatcher();
+
+  function send() {
+    dispatch('message', { text: 'hello' });
+  }
+</script>
+2. 父组件监听
+svelte
+<Child on:message={(e) => console.log(e.detail)} />
+五、状态管理规范（Svelte 5 官方）
+1. 组件内状态：$state
+2. 全局共享状态：$state + 导出（官方标准）
+ts
+// src/lib/stores/appStore.ts
+export const theme = $state('light');
+export const user = $state(null);
+官方规则：
+全局状态直接使用 $state 声明并导出
+无需第三方库
+状态文件放在 src/lib/stores/
+六、TypeScript 规范（官方强制）
+所有文件必须使用 lang="ts"
+svelte
+<script lang="ts">
+禁止使用 any
+接口 / 类型放在 src/lib/types/
+Props、事件、返回值必须强类型定义
+七、组件规范（官方）
+1. 组件命名：大驼峰
+Button.svelte、UserForm.svelte
+2. 样式规范：优先使用 Tailwind 原子类
+- 优先使用 Tailwind CSS v4 原子类（遵循 Tailwind CSS v4 规范）
+- 少量组件特有样式可使用 `<style scoped>`（避免污染全局）
+- 禁止大量自定义原生 CSS 替代原子类
+svelte
+<!-- 推荐：优先使用 Tailwind 原子类 -->
+<div class="relative w-full p-4 flex items-center gap-2 rounded-lg bg-white">
+  <slot />
+</div>
+
+<!-- 仅对组件特有样式使用 scoped -->
+<style>
+  .special-effect { }
+</style>
+3. 逻辑规范
+业务逻辑与 UI 分离
+复杂逻辑抽离到 src/lib/
+组件只做 UI 渲染
+八、指令规范（官方原生）
+{#if}
+{#each}
+{#snippet}（Svelte 5 官方插槽）
+{#key}
+禁止使用第三方指令 / 自定义语法扩展
+九、Svelte 5 废弃语法（严禁使用）
+❌ 禁止 $: 计算属性
+❌ 禁止 export let props
+❌ 禁止 <slot key={}> 旧插槽
+❌ 禁止手动 onMount、beforeUpdate（改用 $effect）
+十、Svelte 5 + Tauri + Svelte Flow 联合规范
+前端 UI：遵循 Svelte 5 官方
+流程图：遵循 Svelte Flow 官方
+桌面能力：遵循 Tauri 官方
+IPC 调用：Tauri 官方 invoke
+状态：Svelte 5 $state
+十一、AI 编码强制规则
+必须使用 **Svelte 5 官方 $ 响应式**（$state/$derived / $effect\）
+Props 必须使用 $props()
+共享状态必须放在 src/lib/stores/
+工具函数必须放在 src/lib/utils/
+组件必须放在 src/lib/components/
+禁止使用任何 Svelte 4 废弃语法
+必须使用 TypeScript
+总结（Svelte 5 官方核心 4 条）
+响应式：$state / $derived / $effect
+Props：$props()
+目录：src/lib/ 为唯一共享目录
+无第三方响应式 / 无旧语法

package/template/rules/Svelte_Flow.mdc

@@ -0,0 +1,176 @@
+---
+description: 
+alwaysApply: true
+enabled: true
+updatedAt: 2026-05-13T04:27:39.806Z
+provider: 
+---
+
+Svelte Flow 项目编码规范（严格遵循 xyflow 官方文档规范）
+适用：@xyflow/svelte 官方标准 | Svelte 4 / Svelte 5 | TypeScript所有规则完全对齐官方 API、官方最佳实践，不自定义野写法。
+一、依赖与版本规范（官方标准）
+唯一官方包：@xyflow/svelte，不安装旧版拆分包、不混用 ReactFlow 依赖。
+始终使用官方稳定版，不装 beta/rc 预发布版。
+安装命令（官方推荐）：
+bash
+运行
+pnpm add @xyflow/svelte
+# 或 npm/yarn
+npm install @xyflow/svelte
+样式引入遵循官方：全局仅引入一次官方内置样式
+ts
+import '@xyflow/svelte/dist/style.css';
+二、项目目录结构（官方组件分层规范）
+严格按官方「画布 - 节点 - 边 - 类型 - 工具」分层，组件统一放在 src/lib/components/ 下（遵循 Svelte 5 官方标准）：
+plaintext
+src/
+├── lib/
+│   ├── xyflow/
+│   │   ├── types.ts          # 官方衍生 TS 类型定义
+│   │   ├── node-types.ts    # 注册自定义节点类型（官方 nodeTypes 规范）
+│   │   ├── edge-types.ts    # 注册自定义边类型（官方 edgeTypes 规范）
+│   │   └── constants.ts     # 画布默认配置、网格、缩放常量
+│   ├── components/
+│   │   └── xyflow/
+│   │       ├── FlowCanvas.svelte       # 根画布容器（官方 SvelteFlow 入口）
+│   │       ├── nodes/                  # 所有自定义节点组件
+│   │       │   ├── InputNode.svelte
+│   │       │   ├── DefaultNode.svelte
+│   │       │   └── OutputNode.svelte
+│   │       └── edges/                  # 所有自定义边组件
+│   │           └── CustomEdge.svelte
+│   └── stores/
+│       └── flowStore.ts      # 遵循官方不可变规则管理 nodes / edges
+└── ...
+三、基础 API 使用规范（严格对齐官方）
+1. SvelteFlow 组件属性规范
+只使用官方原生 Props，不私自封装冗余属性；必须遵循官方默认行为：
+panOnDrag、zoomOnScroll 官方默认行为保留
+fitView 仅初始化按需使用
+snapToGrid、snapGrid 严格按官方类型传值
+官方标准模板（Svelte 5 语法 + Tailwind）
+svelte
+<script lang="ts">
+  import { SvelteFlow, Controls, MiniMap, Background } from '@xyflow/svelte';
+  import '@xyflow/svelte/dist/style.css';
+  import { nodeTypes } from '$lib/xyflow/node-types';
+  import type { Node, Edge } from '@xyflow/svelte';
+
+  const { nodes = $bindable(), edges = $bindable() } = $props<{
+    nodes?: Node[];
+    edges?: Edge[];
+  }>();
+</script>
+
+<!-- 优先使用 Tailwind 原子类 -->
+<div class="w-full h-full min-h-[600px]">
+  <SvelteFlow
+    bind:nodes
+    bind:edges
+    {nodeTypes}
+    fitView
+    panOnDrag={true}
+    zoomOnScroll={true}
+    snapToGrid={false}
+  >
+    <Controls />
+    <MiniMap />
+    <Background />
+  </SvelteFlow>
+</div>
+2. 容器布局强制规则（官方硬性要求）
+官方文档明确：SvelteFlow 必须挂载在有明确宽高的父容器内
+禁止无高度容器、禁止仅靠内容自适应
+所有画布外层容器必须定义 width / height
+四、节点（Node）官方规范
+1. 节点结构遵循官方标准字段
+必须严格遵循官方 Node 类型结构：
+ts
+interface Node {
+  id: string;
+  type?: string;
+  position: { x: number; y: number };
+  data: Record<string, any>;
+  selected?: boolean;
+  dragging?: boolean;
+}
+不得私自新增顶层自定义字段，自定义数据全部放在 data 内部
+id 全局唯一，遵循官方唯一标识规则
+2. Handle 连接点官方规范
+严格区分官方两种类型：
+type="target"：入边 接收连接
+type="source"：出边 发起连接
+位置仅使用官方枚举 Position.Left/Right/Top/Bottom
+自定义节点内 只能渲染 Handle + UI，不写业务逻辑、不写状态变更
+官方标准自定义节点模板（Svelte 5 语法）：
+svelte
+<script lang="ts">
+  import { Handle, Position } from '@xyflow/svelte';
+  import type { NodeProps } from '@xyflow/svelte';
+
+  const { data } = $props<{
+    data: NodeProps['data'];
+  }>();
+</script>
+
+<div class="custom-node">
+  <Handle type="target" position={Position.Left} />
+  <span>{data.label}</span>
+  <Handle type="source" position={Position.Right} />
+</div>
+五、自定义节点 / 边 注册规范（官方 nodeTypes /edgeTypes）
+必须在单独 node-types.ts 集中注册，遵循官方映射规则
+键名对应节点 type 字段，值为 Svelte 组件
+ts
+// $lib/xyflow/node-types.ts
+import InputNode from '$components/xyflow/nodes/InputNode.svelte';
+import DefaultNode from '$components/xyflow/nodes/DefaultNode.svelte';
+
+// 官方标准 nodeTypes 导出
+export const nodeTypes = {
+  input: InputNode,
+  default: DefaultNode
+};
+使用时直接传给 <SvelteFlow {nodeTypes} />，完全遵循官方注册机制。
+六、状态更新不可变规范（官方核心原则）
+官方明确：禁止直接变异 nodes /edges 数组✅ 正确（官方推荐不可变更新）
+ts
+// 新增
+nodes = [...nodes, newNode];
+// 更新
+nodes = nodes.map(n => n.id === id ? {...n, data: newData} : n);
+// 删除
+nodes = nodes.filter(n => n.id !== id);
+❌ 禁止
+ts
+nodes.push()
+nodes.splice()
+nodes[index] = xxx
+统一用 store 管理，严格遵守官方不可变数据流。
+七、事件回调规范（官方原生事件）
+仅使用官方内置回调，不封装自定义事件透传：
+onConnect 连线创建
+onNodeClick 节点点击
+onPaneClick 画布空白点击
+onNodesChange / onEdgesChange 官方数据流变更
+所有事件逻辑写在 FlowCanvas 父组件，自定义节点只做 UI 展示，符合官方组件设计思想。
+八、TypeScript 类型规范（官方类型优先）
+所有节点、边、位置、Handle 类型全部导入官方内置类型
+ts
+import type { 
+  Node, Edge, NodeProps, EdgeProps, 
+  Position, Connection 
+} from '@xyflow/svelte';
+不使用 any，自定义业务数据基于官方 data 扩展接口
+禁止私自改写官方类型定义，如需扩展采用交叉类型
+九、样式与主题规范
+仅引入官方样式一次，不重复导入
+自定义节点样式优先使用 Tailwind CSS v4 原子类（遵循 Tailwind CSS v4 规范）
+少量组件特有样式可使用 <style scoped>（避免污染全局）
+画布内置控件（Controls、MiniMap、Background）直接使用官方组件，不自己复刻
+十、AI 编码强制约束（基于官方规范）
+新增节点必须放入 components/xyflow/nodes 并在 node-types.ts 注册；
+更新 nodes/edges 严格使用不可变替换，禁止原地变异；
+SvelteFlow 父容器必须设置固定宽高，遵循官方布局要求；
+自定义节点仅允许包含 Handle + UI，业务逻辑统一放在外层画布 / Store；
+所有类型、事件、属性只使用官方原生 API，不造私有语法。